home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 020a / niscangs.zip / SAPI.DOC < prev    next >
Text File  |  1991-10-31  |  4KB  |  115 lines
  1.  
  2.                               SAPI scanner driver
  3.                                    SAPI.EXE
  4.                                 November 1, 1991
  5.  
  6. The SAPI scanner driver is a revision 6 scanner driver (see REV6.DOC for 
  7. more information) providing Black and White, Gray Scale and COlor scanning for 
  8. the current ZSoft products.
  9.  
  10. The ZSoft SAPI scanner driver requires the presents of a manufacturer 
  11. supplied scanner driver (referred to in this document as SAPI.SYS since the 
  12. actual name varies from manufacturer to manufacturer.  Logitech's SAPI 
  13. driver is called HHSCAND.SYS).  SAPI.SYS should be loaded before the ZSoft 
  14. driver.
  15.  
  16. SAPI.EXE also REQUIRES that the scanner hardware be setup for interrupts.  
  17. This has NOT been the case for previous ZSoft scanner drivers.
  18.  
  19. The commands provided by the SAPI scanner driver are listed below in the 
  20. example of the /H parameter.
  21.  
  22.     ZSoft Scanner Driver, version 6.00
  23.     Copyright (C) ZSoft Corp. 1991.  All rights reserved.
  24.  
  25.     Valid commands:
  26.  
  27.     /Bxxx  = interrupt Buffer size in K (default is 8k)
  28.         /Cx    = application Code (1-4)
  29.     /H     = display this Help text
  30.     /?     = display this help text
  31.     /Tx    = do diagnostic Testing (verify communication with scanner)
  32.     /V     = Verbose messages and status displays
  33.     /U     = Unload driver
  34.  
  35.  
  36. /B
  37. ==
  38.  
  39. The interrupt buffer will hold the scan data until the application is able 
  40. to retrieve the data from the scanner driver.  If the application can not 
  41. request the data fast enough or often enough then "drop outs" or "hits" can 
  42. occur in the scanned picture.  Increasing the buffer size allots the 
  43. application more time to process the scan data before it must retrieve 
  44. additional data from the scanner driver.  The idea here is to use as small
  45. an interrupt buffer as you can without getting any "drop outs" in your 
  46. pictures.
  47.  
  48. /C
  49. ==
  50.  
  51. In order to maximize the scanner functionality available to the application, 
  52. the /C parameter is used.  This command parameter is usually set by the 
  53. install program.  If the parameter is omitted, the application will still 
  54. work, but may be missing some features.  The codes are:
  55.  
  56.         /C1 = Paintbrush Plus (DOS)
  57.         /C2 = Paintbrush Plus (WIN)
  58.         /C3 = Paintbrush 4 Plus (DOS)
  59.         /C4 = Publisher's Paintbrush (Win)
  60.  
  61.  
  62. Manufacturer Notes
  63. ==================
  64.  
  65. At this time only the Logitech ScanMan and ScanMan 256 have been tested 
  66. with the SAPI.EXE scanner driver.  Any Black and White or Grayscale scanner 
  67. should work with this driver, however, no color support exists at this 
  68. time.  Do to the lack of software control over the Logitech scanners the 
  69. SAPI driver can sometimes return invalid data for a scan.  In order to 
  70. avoid this problem be sure that the switch settings on the hand scanner are 
  71. set to match the selections made in the application.  For the ScanMan 256 
  72. be sure that the mode switch is set to 256 BEFORE SAPI.EXE is loaded or 
  73. grayscale may not be available as an option within the application.
  74.  
  75.  
  76. SAPI Messages
  77. =============
  78.  
  79.     'Supporting: ???????????'
  80.  
  81. This message is displayed upon successful initialization of the SAPI
  82. scanner.  The name and model of the scanner found will be displayed.
  83.  
  84.  
  85. SAPI Error Messages
  86. ===================
  87.  
  88.     'Manufacturer driver not found!  SAPI NOT loaded.'
  89.  
  90. This message is displayed when the scanner driver can not find the "helper" 
  91. driver (provided by the scanner maufacturer).  The ZSoft SAPI scanner 
  92. driver requires that this driver be loaded before we can load.
  93.  
  94.  
  95.     'Scanner not responding (do you have the right address?)'
  96.  
  97. This message is displayed at initialization time if the scanner driver cannot 
  98. successfully communicate with the scanner.
  99.  
  100.  
  101.     'Error communicating with manufacturers driver (????)'
  102.  
  103. This message is displayed when an error occurs while sending or receiving 
  104. information from the manufacturer supplied driver.  An error code is 
  105. included in the message to help identify the problem.
  106.  
  107.  
  108.     'Scanner hardware not configured for interrupts!'
  109.  
  110. The SAPI.EXE driver requires interrupts to function.  The scanner 
  111. hardware interface must be configured to use interrupts.  With most 
  112. manufacturers drivers the interrupt can be set with a command line 
  113. parameter to the driver (e.g. /I=7, sets interrupt 7).
  114.  
  115.